Summary

• add built-in agent id trae with command trae-cli acp serve
• document Trae CLI in built-in agent docs (README.md, agents/README.md)
• add agents/Trae.md
• update registry tests to include trae

Why

Today users must manually configure Trae CLI in ~/.acpx/config.json.
Making it built-in reduces setup friction and aligns with existing built-in agent UX.

Changes

• src/agent-registry.ts
  • add: trae: "trae-cli acp serve"
• README.md
  • built-in agents table adds Trae row
• agents/README.md
  • built-in list and docs index include Trae
• agents/Trae.md
  • new agent doc page
• test/agent-registry.test.ts
  • expected built-in list includes trae

Validation

• pnpm -s run build:test && node --test dist-test/test/agent-registry.test.js
• local runtime checks:
  • acpx --cwd /tmp --approve-all trae exec "Reply exactly: TRAE_ACPX_EXEC_TMP_OK"
  • session flow (sessions new / prompt / sessions history)
  • file write tool path test (TRAE_FILE_OK)
  • no-custom-config check:
    • remove agents.trae from ~/.acpx/config.json
    • run local packed build: npx --yes ./acpx-0.3.1.tgz --cwd /tmp --approve-all trae exec "Reply exactly: LOCAL_PUBLISH_TRAE_OK"

~/.acpx/config.json migration note

For users on this PR (or after release), agents.trae becomes optional.

Before:

{
  "agents": {
    "trae": { "command": "trae-cli acp serve" }
  }
}

After (optional cleanup):

{
  "agents": {
    "claude": { "command": "..." }
  }
}

If users want custom behavior, keeping an override is still supported:

{
  "agents": {
    "trae": { "command": "trae-cli acp serve" }
  }
}

Notes

• built-in agent id remains trae for compatibility
• underlying executable is trae-cli